package cloud.quan.service;

import java.util.Map;

/**
 * API 文档： https://open.pinduoduo.com/#/apidocument?docId=12
 */
public interface PddService {
    /**
     * 获取商品详情
     *
     * @param goodsId 商品 id
     * @param pId     推广位 id
     * @return 商品详情
     */
    String goodsDetail(Long goodsId, String pId) throws Exception;

    /**
     * 关键字搜素商品商品分页
     *
     * @param keyword  关键字
     * @param page     当前分页
     * @param pageSize 分页大小
     * @param sortType 排序方式
     * @param pId      推广位 id
     * @param listId   翻页时建议填写前页返回的list_id值
     * @return
     */
    String goodsSearch(String keyword, Integer page, Integer pageSize, Integer sortType, String pId, String listId) throws Exception;

    /**
     * 获得拼多多商品标签列表（非商品类目cat)
     * 值=0时为顶点opt_id,通过树顶级节点获取opt树
     *
     * @param parentOptId 父级
     * @return 商品标签列表
     */
    String goodsOptGet(Integer parentOptId) throws Exception;


    /**
     * 商品标准类目接口
     *
     * @param parentCatId 值=0时为顶点cat_id,通过树顶级节点获取cat树
     * @return
     */
    String goodsCatsGet(Long parentCatId) throws Exception;

    /**
     * 获取主题列表
     *
     * @param pageSize 分页大小
     * @param page     当前分页
     * @return
     */
    String themeListGet(Integer pageSize, Integer page) throws Exception;

    /**
     * 获取主题商品
     *
     * @param themeId 主题ID
     * @return
     */
    String themeGoodsSearch(Long themeId) throws Exception;


    /**
     * 获取推广链接
     *
     * @param pId      推广位 id
     * @param goodsId  商品 id
     * @param searchId 搜索id，建议填写，提高收益。
     *                 来自pdd.ddk.goods.recommend.get、pdd.ddk.goods.search、
     *                 pdd.ddk.top.goods.list.query等接口
     * @return
     */
    String goodsPromotionUrlGenerate(String pId, Long goodsId, String searchId) throws Exception;
}
